home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / wc3x / hscats.zip / HSCATS.DOC < prev    next >
Text File  |  1992-02-18  |  9KB  |  198 lines
  1.                                  H S C A T S
  2.                                  Version 2.1
  3.  
  4.  
  5.                  WILDCAT 3.xx AND HSLINK INTERFACE HELP DOC'S
  6.                  --------------------------------------------
  7.  
  8.    Here it is!  Wildcat and HsLink, together.
  9.    The saga continues..........
  10.  
  11.    If you have used HsLink, you know it is a powerful file transfer
  12.    protocol that allows you to download and upload at the same time
  13.    when the user selects to download with HsLink, essentially
  14.    doubling your throughput.  HsCats will interface HsLink to Wildcat
  15.    so your users can enjoy this terrific protocol on your Wildcat system.
  16.  
  17.    HsCats has three parts PREHSCUP, PREHSCDN, and AFTHSCDN.
  18.    These are called from the batch protocol file either HSLUP.BAT or
  19.    HSLDN.BAT. Here how it works...pay close attention!
  20.  
  21.    USER DOWNLOAD SESSION:
  22.  
  23.    The user marks off what files they wish to download via Wildcat's file
  24.    marking system. Just as they would with any other protocol. They then
  25.    select to download and are offered the protocol menu screen. They select
  26.    [H] for HsLink and away we go.....
  27.  
  28.    The HSCDN.BAT batch file first calls PREHSCDN.EXE which prompts the
  29.    user for an area to upload to (that they have security for) and writes
  30.    two files...HSCAT.### (Area chosen by user) and HSACESS.### (which is
  31.    the pointer file for areas that they have security to download from).
  32.    It will write this info to the HsLink.Cfg file that you point to on
  33.    the command line.
  34.  
  35.  
  36.    AFTHSCDN.EXE will then be called in the batch file and read the
  37.    STATUS.LOG and HSCAT.### files and add whatever files where uploaded
  38.    during the download session to the Wildcat database. It then updates the
  39.    user record for files uploaded and extra time alloted. Wildcat will take
  40.    care of updating the user and file database for files that where downloaded.
  41.  
  42.    USER UPLOAD SESSION:
  43.  
  44.    The user selects the area to upload to via Wildcat as normal. Then WC
  45.    will ask for filenames, descriptions, passwords, keywords, and additional
  46.    info as it does for any protocol used. The user then selects [H] HsLink
  47.    from the protocol menu as transfer type to use.
  48.  
  49.    The HSLUP.BAT batch file first calls PREHSCUP.BAT which sets up the
  50.    HsLink.Cfg file for the proper path to the node's ep directory.
  51.  
  52.    HsLink will then run and send whatever files the user has configured
  53.    in the upload transfer to the node's ep directory. At present HsLink
  54.    only allows bidirectional transfers to occur when the user selects
  55.    downloading. If they select uploading it will only allow the upload
  56.    to occur. Hope Sam Smith will add that feature in a future version..
  57.    I have the code to make it work in HsCats should he do so.
  58.  
  59.    In a nut shell...it's kinda like merging HsCats and Wildcat together into
  60.    one package...simply called HsCats.
  61.  
  62.  
  63.                                 SETUP
  64.  
  65.  
  66.    Setting things up is simple, and we'll go through it step by step.
  67.                                                                        
  68.             USE A WORK DIRECTORY FOR YOUR UNARCHIVING OF FILES
  69.  
  70.    Create a new directory to work in.  This keeps things much easier to
  71.    follow along with and clean up after.
  72.  
  73.    Ok, here we go.
  74.  
  75.    1.  Take all the .EXE files from the HsLink archive (HSLxxx.ZIP)
  76.    and put them in any directory that you have your dos environment
  77.    'path' set up for.  Type 'set' at the dos prompt to check.  I set
  78.    everything into a directory called c:\wc\ep and include it in the
  79.    path statement in my autoexec.bat.
  80.  
  81.    2.  Do the same thing with the *.EXE files from this (HSCATSxxx.ZIP)
  82.    archive.  All the files should now be available in the path.
  83.  
  84.    3.  Place the copy of HSLINK.CFG I have included into each of your
  85.    node home directories. IE: c:\wc30\wcwork\node1, c:\wc30\wcwork\node2,
  86.    etc.
  87.  
  88.    4.  In each directory that you put a copy of HSLINK.CFG, run
  89.    HSCONFIG to make changes necessary for your system.  The copy I have
  90.    included is a regular setup and should not require much modification.
  91.    Make changes to this section as follows. Remember to run HSCONFIG from
  92.    the node directory! You should refer to the HsLink Docs for further
  93.    information regarding HsLink's options.
  94.  
  95.  
  96.        A. 'Directory for downloaded files' should be set to your node's
  97.    ep directory.  HSCATS will do all that work for you for each caller
  98.    engaged in a HsLink session. We only need to fill it in the first
  99.    time.
  100.  
  101.    5.  Complete steps 4.A through 4.K for each one of your nodes if you
  102.    are multi-node Wildcat.
  103.  
  104.    7.  Copy the enclosed HSLDN.BAT and HSLUP.BAT batch files to your
  105.    home directory. Then change to the home directory. Edit whatever you
  106.    need to on the batch files I have included.
  107.  
  108.    8.  Run Makewild (still in the home directory) and go to the External
  109.    Protocol section. Add HsLink to the external protocol menu as such:
  110.  
  111.    [H]  HsLink  HSLUP.BAT  HSLDN.BAT   Y
  112.  
  113.    * Environment Variables, there are a few you need to set to have
  114.    HsCats operate properly. Make sure you set the following variables
  115.    in each of your cat#.bat files.
  116.  
  117.    IE: Set WCNODEID=(node you are on ie: 1)
  118.        Set WCPORTID=(port you are using on that node ie: 1)
  119.        Set HOMEPATH=(path to home directory ie: C:\WC30\)
  120.        Set NODEPATH=(path to node directory ie: C:\WC30\WCWORK\NODE1\)
  121.  
  122.    * Remember to add the extra backslash at end of directories above.
  123.  
  124.    * HsCats offers file virus scanning via ScanFile.Bat If HsCats
  125.    finds the file "SCANFILE.BAT" it will shell to EMS or DISK before
  126.    adding the file to Wildcat's database. ScanFile.Bat will do it's normal
  127.    job of scanning the file. If the file fails, HsCats will add it to
  128.    the database with the failed scan flag set to Y. It will also subtract
  129.    the file and upload kilobytes from the users record. At present I have
  130.    only tested CatScan, which operates properly. Other scanners may be
  131.    used but I can only atest to the fact that CatScan causes no problems.
  132.  
  133.                                ┌──────────────┐
  134.                                │ UPLOAD NOTES │
  135.                                └──────────────┘
  136.  
  137.    Through the use of PREHSCDN.EXE, a single selectable upload area is
  138.    supported, so the user may upload to an area of their choice that they
  139.    have access to normally.  All uploads that occur during any one
  140.    session will go to the area that the user so chooses, they will only
  141.    be allowed to choose areas for which they have security for. This
  142.    means for each HSLINK session they can select the area they want to
  143.    upload too.
  144.  
  145.    Save Upload's to Which Area ("?" for Choices) ?
  146.  
  147.    [1] New Uploads   [26] Sysop Only!
  148.  
  149.    They will only be shown areas for which they have security for in WC!
  150.   
  151.    * At present the user must still select the area manually, even if they
  152.    are allowed only one area to upload to.
  153.  
  154.    * Special Note, HsLink only allows dual transfers during a user
  155.    download. If the user selects upload it will only allow the upload,
  156.    downloads will not occur. Only the download selection will allow
  157.    a upload to also occur.
  158.  
  159.    * Wildcat in its wctext.dat tells the user to start the HsLink transfer
  160.    now! when download is selected. This occurs before the user is asked
  161.    by HsCats which file area to upload to. You can do what I did and use
  162.    your mkwctext and change the prompt # 542 to one that will not cause
  163.    a conflict, such as:
  164.  "HsLink & BiModem User's, StandBy to select an upload area! (CTRL-X) aborts!"
  165.  
  166.  
  167.    So there you have it in a nut shell. It is easy to setup and totally
  168.    worth the effort!!!! If you should have any questions please feel
  169.    free to call me and I will help you out. I can be reached at my BBS
  170.    from 8pm till 8:00am (East Coast Time), Which at present is the only
  171.    hours my bbs will be up and running. PLEASE do not call anytime other
  172.    than the hours specified until I get another phone line installed.
  173.    The BBS # is (717)-731-8299 (19,200 V42/Bis) Good Luck and thanks for
  174.    supporting HSCATS, HSLINK & WILDCAT!
  175.  
  176.  
  177.  
  178.                                               Enjoy!        02/18/92
  179.  
  180.                                 Dale Fedorchik
  181.                              The Cat's Castle BBS
  182.  
  183.  
  184.                                  Warranty
  185.  
  186.  
  187.    This is product is provided "as is" without warranty of any kind. The
  188.    entire risk as to the results and performance of the program is
  189.    assumed by you. Futher more, I the author do not warrant, guarantee,
  190.    or make any representations regarding the use of, or the results of
  191.    the use of the program, and you rely on the program and results
  192.    solely at your own risk. I the author cannot accept responsibility
  193.    for system damage, loss of profit, or any other special, incidental,
  194.    or consequential damages resulting from the use or inability to use
  195.    this product.
  196.  
  197.  
  198.